home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / karaok20.zip / KARAOKE.DOC < prev    next >
Text File  |  1993-06-03  |  13KB  |  271 lines
  1.  
  2.                               *********************
  3.                               *      KARAOKE      *
  4.                               *********************
  5.                                   Version  2.00
  6.                                    User Manual
  7.  
  8.                         (c) 1992, 93 dgs software / music
  9.                               an ExCiTe! production
  10.  
  11.  
  12.  
  13. Author       : Davide Guida (DGS)
  14. Address      : Via Rodolfo Falvo 10, Napoli (Italy)
  15. E-MAIL       : progetto@csdux01.cised.unina.it
  16.                (see paragraph #9 for E-MAIL instructions)
  17. Release Date : May 31st, 1993
  18.  
  19.  
  20.  
  21. 1. WHAT IS KARAOKE
  22.  
  23. Originally, KARAOKE is a game allowing you to sing your favorite song while
  24. listening the original music background. Doing it, learning song is easier and
  25. faster. My program KARAOKE is similar, but based on SoundBlaster .MOD files: if
  26. you have a .MOD collection for your PC, being based on popular songs, you can
  27. sing their lyrics on the music. See 'DGS PRODUCTS' for informations about some
  28. module collection available via Internet.
  29.  
  30.  
  31. 2. HARDWARE REQUIRED FOR USING KARAOKE
  32.  
  33. In order to use KARAOKE you need the following hardware:
  34.  
  35. - PC 386/486, 16MHz or better. 640k RAM needed. No Expanded Memory reqyired.
  36. - Hard disk with 400k space free.
  37. - Sound Blaster recommended, but a DAC on LPT1 or Speaker can be used with
  38.   low quality. Sound Blaster PRO, Aria Card and Pro Audio Spectrum will be
  39.   available in next releases.
  40. - VGA or SUPERVGA Card, with at least 256k memory.
  41.  
  42. NOTE: 286 users must download old KARAOKE versions in order to use it. This
  43.       version supports only 386 machines.
  44.  
  45. In order to install KARAOKE, you must create a directory on your hard disk
  46. and unzip distribution file (KARAOK2.ZIP) into it. Then, type KARAOKE and
  47. press <ENTER> to run it.
  48.  
  49.  
  50. 3. HOW TO USE KARAOKE
  51.  
  52. KARAOKE is easy to use. You can play 15-channel SoundTracker Modules (.MOD),
  53. 31-channel 4-voice NoiseTracker modules (.MOD), Multi-channel FastTracker
  54. modules (.8CM and .6CM), Scream-Tracker 2.0 and 3.0 files (.STM and .S3M)
  55. and Otto Chrons' .AMF modules.
  56. You can choose a module from your disk by using the file requester: if you
  57. want to give a filename by your own, press <TAB> and insert file name in the
  58. data input field. Press <ENTER> when you've choosen the module, or press
  59. <ESC> to abort. If you've a mouse installed (and its driver), you can use it
  60. easily.
  61. Now, choose an output device: possible choices are PC-Speaker, a Covox DAC
  62. card on LPT1, a Disney Sound Source on LPT1 parallel port, and Creative Labs'
  63. SoundBlaster Card. Your SoundBlaster must be installed on 220h port. See your
  64. SoundBlaster's manual for information about to set I/O port on your card.
  65. Then, choose a frequency mix rate, based to your PC's speed. You can choose
  66. high values if you've a fast PC, so you will have a better sound quality. A
  67. good value is 15000 for all computers. Remember your sound card's limits. eg.
  68. if you've a Sound Blaster Card Release 1.x or 2.x, you cannot select a mix
  69. rate higher than 22000. For Covox DAC cards, you can pull frequency mix rate
  70. up to 44100 Hz for better quality.
  71. Now the module will be loaded into memory (if you've enough RAM for it) and
  72. played. But KARAOKE is not a simple player. If your module is called GOOFY.MOD
  73. and if a file called GOOFY.KDT is present in the same directory, it can be
  74. considered as a KARAOKE script file and used for displaying lyrics (see the
  75. paragraph 4 for the file structure). If the .KDT file is not present, module
  76. will be played normally as if it was played by a classical module player.
  77. Screen will be switched to VGA graphics mode (320x200, 256 colors) during song
  78. playback, giving a nice look.
  79. You can stop music playing, and return to DOS by pressing <ESC> once or twice.
  80. Effect may not be immediate, so press <ESC> more than once if key pressure had
  81. no effect.
  82.  
  83.  
  84. 4. KARAOKE SCRIPT FILES
  85.  
  86. KDT script files contain lyrics. You can find some .KDT file together with
  87. its .MOD file on several BBS or FTP sites. Script file is a simple text file.
  88. There's an example on this KARAOKE release, to use with a .MOD, also included
  89. in the package.
  90. All lines with a '#' or a ';' in the first column are considered as comments
  91. and will be ignored by KARAOKE. If no '#' (or ';') is present in the first
  92. column, text line is considered as a timer, and following text line as a
  93. lyrics string. The lyrics string corresponding to timer will be displayed
  94. when song relative timer reaches specified value.
  95.  
  96. EXAMPLE: We have the following script file:
  97.  
  98.                  ; SCRIPT FILE - EXAMPLE 1
  99.                  00:05
  100.                  That's only what I want
  101.                  00:08
  102.                  In this world
  103.                  00:12
  104.                  In this stupid world
  105.                  00:16
  106.                  Now that's time to go out
  107.                  00:19
  108.                  and tell you I love her....
  109.  
  110. First text row is a comment and will be ignored.
  111. Second and third text row tells KARAOKE to display the string "that's only what
  112. I want" when song timer reaches 00:05 value, that is, after five seconds song
  113. has started. In fact, KARAOKE will display three rows at a time, but first of
  114. them will be displayed in 'reverse' colors so it will be hilited. After three
  115. seconds (00:08), lines will be scrolled, so that the hilited row will be the
  116. second ("In this world"), the third and the fourth will be displayed using
  117. standard colors (that is, song text is 'scrolled' one line up). And so on.
  118. You can make your own Script Files. After you've listened a song and stored
  119. right timings on a paper, you can create your script file by placing all
  120. lyrics phrases corresponding to right timings. It could take a while, but you
  121. can speed up this procedure, by using one of utilities provided with KARAOKE
  122. (see par. 6)
  123.  
  124.  
  125. 5. LIMITATIONS
  126.  
  127. - KARAOKE needs a 80386 PC to run, then users having a 8086 or a 80286 should
  128.   to update their computer in order to use it.
  129. - You can have several problems when you try to play modules larger than 350k.
  130.   Then, if no sound is heard, or a 'allocation error' message is displayed,
  131.   probably the module is larger than available memory.
  132. - The maximum number of lyrics phrases in a song must be 500. I think that's
  133.   enough for most of the songs (A song having three verses, one bridge and
  134.   three chorus, uses about 100 phrases).
  135. - Be sure lyric phrases aren't longer than 45 chars or text will go out of the
  136.   screen. Also, lyric phrases shouldn't be longer than 70 chars or system may
  137.   crash.
  138.  
  139.  
  140. 6. UTILITIES
  141.  
  142. Distribution disk contains also other programs you can find useful.
  143.  
  144. -KARGRAB.EXE : This is an event capture for KARAOKE. If you have lyric text,
  145.                load your module in this utility, then press space every time
  146.                you want to insert a new 'phrase' in the script file. When you
  147.                press space, current song time will be stored in a file called
  148.                like the module but with '.KTM' extension. When you've stored
  149.                up all song timings, press <ESC> key. Now, load .KTM file into
  150.                a text editor, them add all lyrics phrases manually. You can
  151.                save result file by using a .KDT extension. If you've already
  152.                lyrics stored in a file, you can use KARFC.EXE described below.
  153.                If some error will occur during playback (eg. phrases not cor-
  154.                responding to timings), verify your song text file and correct
  155.                wrong timings manually (using a text editor). If you are not
  156.                able to find an error cause on the song text file, rerun KARGRAB
  157.                and make the timing file again.
  158.  
  159. -KARFC.EXE   : If you've a lyrics on a file, you can automatically merge it
  160.                to a file created with KARGRAB.EXE. The lyrics must have same
  161.                name of the timing file, but the extension must be .KLR. The
  162.                result file will have a .KDT extension, so that, if everything
  163.                goes well, you can use it directly with KARAOKE. If number of
  164.                timings don't correspond to numbers of phrases, something went
  165.                wrong, you can notice it if some phrase don't have a correspon-
  166.                dent timing in the .KDT, or vice versa. In such case, verify
  167.                where is the possible  error position, then run KARGRAB again,
  168.                paying attention to THAT position. You can also backup old
  169.                .KTM file, so you can compare both files and reduce your work.
  170.                If you notice you forgot only one timing (it's the most pro-
  171.                bable case), you can backup your old .KTM file, rerun KARGRAB
  172.                (or KARAOKE directly), pay attention only to event you forgot
  173.                previous time and edit timing file so that time will be reduced
  174.                a lot.
  175.  
  176. -PLAYMOD.EXE : plays a module file in background mode on a fast computer. You
  177.                must specify a file name and a frequency mix rate on the command
  178.                line. Module will be loaded into memory, then COMMAND.COM will
  179.                be launched allowing you to work in DOS mode. Free memory can
  180.                depend especially from module length. Type EXIT to stop music.
  181.                Please don't use a Memory Manager with this utility. If one is
  182.                installed, your system may crash. Use a frequency mix rate in
  183.                the range 5000-16000, based on computer you have. You can use a
  184.                80286 processor in order to run this utility, but your computer
  185.                can hang if it's not enough fast.
  186.  
  187.  
  188. 7. HISTORY
  189.  
  190. Version 2.00  (05/31/93)
  191.  
  192.         + Changed Module Playing Routines
  193.         + Added STM / 8CM / 6CM / S3M / AMF support
  194.         + Added module informations on the screen
  195.         - 286 support is down (KARAOKE runs only on 386/486 machines now)
  196.  
  197. Version 2.00ß (05/01/93)
  198.  
  199.         + Karaoke's desktop is totally changed by using VGA graphic support.
  200.         + Added a file requester in order to 'pick' a module.
  201.         + Fixed some bug to PLAYMOD (v1.1 released).
  202.  
  203. Version 1.01  (12/02/92)
  204.  
  205.         + First release available via FTP
  206.         + Fixed a bug in the timing counter
  207.         + Fixed other minor bugs.
  208.  
  209. Version 1.00  (11/29/92)
  210.  
  211.         + First release.
  212.  
  213.  
  214. 8. LAST REMARKS
  215.  
  216. The program is totally freeware. You can copy and distribute it. If you're
  217. interested to following releases, you can mail me. No part of this program can
  218. be modified in no way. All KARAOKE features are copyrighted by Davide Guida,
  219. except for playing routines, making part of Otto Chrons' DSMI package. KARAOKE
  220. is available on cs.uwp.edu Anonymous FTP site. You can find it on some other
  221. Anonymous FTP sites too, but you must look for it. You should find some .KDT
  222. file in the /pub/music/lists/btl/mods directory, based on Debbie Gibson MOD
  223. files uploaded here.
  224.  
  225.  
  226. 9. E-MAIL TECHNICAL SUPPORT
  227.  
  228. KARAOKE technical support is available also via E-MAIL, by writing to:
  229.  
  230. Davide Guida
  231. progetto@csdux01.cised.unina.it
  232.  
  233. (it's good if you specified receiver name, 'cause this e-mail address belongs
  234.  to a programming team and NOT to a single person)
  235.  
  236. If E-MAIL fails, for some cause, you can TELNET to csdux01.cised.unina.it on
  237. port 25 and use the SENDMAIL port directly. Here's the exact procedure (all
  238. sentences after '>' must be typed from your terminal, all sentences included
  239. in '<' and '>' must be substituted by true text)
  240.  
  241.                     telnet> open csdux01.cised.unina.it 25
  242.                     Trying...
  243.                     Connected to csdux01.cised.unina.it
  244.  
  245.                     csdux01 SENDMAIL port ready.
  246.  
  247.                     >MAIL FROM: <your complete e-mail address>
  248.                     >RCPT TO: progetto
  249.                     >DATA
  250.                     ><your mail>
  251.                     >.
  252.                     >QUIT
  253.  
  254. csdux01.cised.unina.it is mapped to numeric address 192.132.34.12
  255.  
  256.  
  257. 10. DGS PRODUCTS
  258.  
  259. - A Protracker Module collection is available by DGS. You can mail me in
  260.   order to know how you can have it. The collection contains some popular
  261.   songs. Also, a Debbie Gibson's module collection is available for her fans.
  262.   This collection is available on cs.uwp.edu (/pub/music/lists/btl/mods)
  263.   and info.brad.ac.uk (/misc/mods/debbie) anonymous ftp sites.
  264.  
  265. - The Postering Image collection is available by DGS. It includes a freeware
  266.   image viewer in order to display these images. You can find some image
  267.   also on cs.uwp.edu picture directories. They have .HS2 extension.
  268.  
  269.  
  270.  
  271.